home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / catD / scsi_ioctl.z / scsi_ioctl
Encoding:
Text File  |  1998-10-30  |  3.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ssssccccssssiiii____iiiiooooccccttttllll((((DDDD3333XXXX))))                                                ssssccccssssiiii____iiiiooooccccttttllll((((DDDD3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      scsi_ioctl - perform host adapter ioctl
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ssssccccssssiiii....hhhh>>>>
  14.  
  15.      iiiinnnntttt
  16.      ((((****ssssccccssssiiii____iiiiooooccccttttllll))))(((( vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt _c_t_l_r__v_h_d_l,,,,
  17.                       uuuuiiiinnnntttt _c_o_m_m_a_n_d,,,,
  18.                       ssssttttrrrruuuucccctttt ssssccccssssiiii____hhhhaaaa____oooopppp ****_o_p_e_r_a_n_d))));;;;
  19.      The _s_c_s_i__i_o_c_t_l interface is used by user level administrative
  20.      applications (with privileged access) to perform operations on a scsi
  21.      bus, fibre channel loop, or directly to a host adapter.
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      The _c_t_l_r__v_h_d_l argument specifies the hwgraph vertex for the SCSI host
  25.      adapter.  The _c_o_m_m_a_n_d argument specifies what operation is requested.
  26.      There is a list of these operations in /usr/include/sys/scsi.h, all of
  27.      which have a name of the form SOP_*.  See scsiha(7m) for additional
  28.      information.  The _o_p_e_r_a_n_d argument is a pointer to a scsi_ha_op
  29.      structure, which is used to supply additional information to the
  30.      _s_c_s_i__i_o_c_t_l function.  Two adapter-specific ioctls have been defined:
  31.      SOP_GETDATA and SOP_SENDDATA.  With them an application and driver can
  32.      perform activities beyond those defined by the other SOP_* ioctls.
  33.  
  34. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  35.      _s_c_s_i__i_o_c_t_l returns 0 if there is no error.  Otherwise, it returns a
  36.      standard error number (see /usr/include/sys/errno.h).
  37.  
  38. NNNNOOOOTTTTEEEESSSS
  39.      _s_c_s_i__i_o_c_t_l is stored as a function pointer in the scsi_ctlr_info_t
  40.      structure, which is associated with the scsi host adapter vertex in the
  41.      hwgraph.  The information structure in the scsi target vertex also has a
  42.      pointer to the scsi_ctlr_info_t of the host adapter that the target is
  43.      connected to.  Given a _l_u_n__v_h_d_l (vertex handle of the device) the
  44.      _s_c_s_i__a_l_l_o_c function can be called as follows:
  45.  
  46.               scsi_lun_info_t *scsi_lun_info;
  47.            ...
  48.               scsi_lun_info = scsi_lun_info_get(lun_vhdl);
  49.               SLI_IOCTL(scsi_lun_info)(lun_vhdl,option,callback_function);
  50.  
  51.  
  52. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  53.      comments in /usr/include/sys/scsi.h, hwgraph.intro(D4X), scsi_alloc(D3X),
  54.      scsi_free(D3X), scsi_info(D3X), scsi_command(D3X), scsi_abort(D3X), SCSI
  55.      chapter of the IRIX Device Driver Programmer's Guide.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.